home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / os2 / plnk081.zip / pilot-link.0.8.1 / README < prev    next >
Text File  |  1997-07-03  |  4KB  |  79 lines

  1.  
  2. Sorry for not providing decent information here. The basics are:
  3.   
  4.   1) run configure (unless using OS/2). If you want to install in someplace
  5.      other the /usr/local, give configure an argument like '--prefix=/usr/pilot'
  6.     
  7.   2) run make (unless using OS/2, then make -f Makefile.os2)
  8.     
  9.   3) play around, _carefully_. pilot-xfer is probably the most useful
  10.      program for you, and also the safest.
  11.      
  12.   4) run 'make install' if you feel the need.
  13.      
  14. Note on pilot-debug: this program is a work-in-progress, and requires Tcl
  15. 7.5 (or greater) and optionally Tk 4.1 (or greater) and/or Readline 2.0.
  16. You'll need to modify Makefile to to use Readline 2.0, and if your Tcl or Tk
  17. aren't in standard places, you'll need to wiggle configure or the Makefile.
  18. You must have install pilot-link or else run pilot-debug in the pilot-link
  19. source directory if you want the fancy images for the Remote UI window.
  20.  
  21. Usage notes:
  22.  
  23.   read-ical and sync-ical will only run if you have ical-2.x installed and
  24.   in the path.
  25.   
  26.   sync-mail and sync-memodir are useless stubs at the moment.
  27.   
  28.   The default connection rate is 9600 baud. You are welcome to try higher
  29.   baud rates (19200, 38400, or 57600) by setting the PILOTRATE environment
  30.   variable, but various machines have various limitations. (Be careful about
  31.   38400 on a Linux box if you've been using setserial to change the
  32.   multiplier.)
  33.   
  34.   pilot-mail (which requires a PalmPilot with the new Mail application, as
  35.   well as sendmail and/or a POP3 server) is still in the experimental stage. 
  36.   Run with an argument of '-H' for help. While I don't expect it to lose
  37.   data, (and by default mail is kept on both sides, not deleted) I can not
  38.   and will not guarantee that you won't. Please back up your UNIX mailbox
  39.   and Pilot mailbox (via pilot-xfer) before experimenting.
  40.   
  41.   If you wish, you may easily change the default settings (pop host,
  42.   password, etc.) for pilot-mail by editing the top of pilot-mail.c, as well
  43.   as by setting the environment variables indicated in its help.
  44.   
  45.   Scott Grosch's "validate" program is included, and can be made via 'make
  46.   validate', but it may not be of use to anyone but Scott.
  47.  
  48. Debugging notes:
  49.  
  50.   There are several defines mentioned in lib/Makefile that enabled different
  51.   types of debugging information. 
  52.   
  53.   If you are having problems, it may help to generate a log of all serial
  54.   transactions, which I can then parse and attempt to understand. To
  55.   generate such a log, please set the PILOTLOG environment variable (it does
  56.   not matter to what you set it.) This will cause any program using
  57.   pilot-link to append to a log file called "PiDebug.log" in the current
  58.   directory. You may choose another name or directory via the PILOTLOGFILE
  59.   environment variable.
  60.   
  61.   Please mail me (kjahds@kjahds.com) such a log if you are having low-level
  62.   failures.
  63.   
  64. Embedding information:
  65.  
  66.   As of 0.5.0, I've rearranged the headers slightly so that it should be
  67.   easier and more reliable to use the libpisock.a library in external
  68.   applications.
  69.   
  70.   If you want to use the pilot-link portability layer (configured via
  71.   autoconf), then include pi-source.h. Otherwise, do not touch this file,
  72.   as it sets up a mildly complex environment.
  73.   
  74.   For all normal operations, simply include the obvious files (pi-file for
  75.   .pdb and .prc file access, pi-dlp for DLP sync functions, etc.). pi-macros
  76.   contains the portable byte-access routines.
  77.   
  78. Happy Hacking,
  79. Kenneth Albanowski <kjahds@kjahds.com>